home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / os2 / wuz11a.zip / WUZ.DOC < prev    next >
Text File  |  1994-02-07  |  12KB  |  260 lines
  1. --------------------- Workplace Shell UnZip  version 1.1 ---------------------
  2. --------------------- (c) Copyright 1994 Scott Maxwell. ----------------------
  3. ----------------------- by: scott.maxwell@channel1.com -----------------------
  4.  
  5.  
  6. If you don't want to read this big file right now, read Readme.WUZ
  7. instead.  You might want to read this later, though.
  8.  
  9.  
  10.  
  11. Welcome to WPS UnZip!
  12.  
  13. Actually, it does more than just unzip.  It can also handle ARC, ARJ, LZH,
  14. TAR, Z and ZOO files.  You need to have unpackers for each format but then
  15. WPS Unzip will handle the rest.  WUZ is already set up to use OS/2 versions
  16. of Zoo 2.1, Info-Zip's Unzip 5.0, UnArj 2.41, LH2 2.14, Gnu Tar and Compress.
  17. If you want to use a different dearchiver or add another archive type, you
  18. may have to make some changes to Wuz.Cmd.  See "Adding a New Archive Type" at
  19. the end of this file.  The default dearchiver is UnZip if the file extension
  20. is not recognized.  I use this to drag-and-drop QWK files when I just want to
  21. look at my bulletins.
  22.  
  23. To install, just type Inst-WUZ and select a directory for the executable files
  24. from the menu.  Then enter the name of the directory where you want temporary
  25. directories to be made.  I use E:\Download\Temp.  This will copy all of the
  26. executable and icon files to the specified directory and create an icon on the
  27. desktop called "WPS Unzip" which is associated with *.arc, *.arj, *.lzh, *.tar,
  28. *.z, *.zif, *.zip and *.zoo.  It will also create a second icon for zipping
  29. up whole directories in place called "Zip Directory".  To uninstall, simply
  30. rerun Inst-WUZ and select uninstall from the menu.
  31.  
  32. Now all of your archive files should have a cool zipper icon.  If you don't
  33. see the zipper right away, try clicking the right button over the file icon
  34. and it should change.
  35.  
  36. You can open an archive in one of three ways:
  37. 1) Double click on the file icon.
  38. 2) Drag the file icon to the WPS Unzip icon
  39. 3) Type WUZ <filename> from a command line
  40. Note: Technique 2 or 3 may be used to extract self-extracting archives (*.EXE)
  41.  
  42. WUZ will then create a directory of the same name as the archive in whatever
  43. directory you told it to during the install, in my case E:\Download\Temp.
  44. After creating the directory, WUZ will extract the archive file into it, open
  45. the directory as a folder on the Desktop and open a separate OS/2 window
  46. set to the new directory.  This will give you easy access from both the WPS
  47. and the command line.  Also, since each archive creates its own extract
  48. directory, you can open as many archives at the same time as you like.
  49. If you are using 4OS2, the command-line window will be opened as local so
  50. it won't use any of your aliases.  WUZ needs to do this so it can create
  51. some custom keyboard aliases.
  52.  
  53. To remove the extracted files and the temporary directory, you can type ZClr.
  54. ZClr -x will close the OS/2 window as well.  If you are using 4OS2, you can
  55. just type Alt-x.
  56.  
  57. If you are using ZIP archives, two other options are available: updating and
  58. refreshing.  ZUPDATE will add any new files you have added to the extract
  59. directory to the original archive and optionally remove any files that you
  60. have deleted.  For instance, rename Try.Cmd to Tried.Cmd and do ZUPDATE and
  61. you will be asked if you want to delete Try.Cmd from the archive.  Then
  62. Tried.Cmd will be added to the archive.  If you are using 4OS2, just hit
  63. Alt-u.  ZFRESH will update only those files that already exist in the
  64. archive and have changed in the extract directory.  Alt-f for 4OS2 users.
  65.  
  66. I don't like seeing ZClr.Cmd, ZFresh.Cmd and ZUpdate.Cmd all the time, so I
  67. have hidden them.  If you want to unhide them so that you can use them
  68. from the WPS, just comment out the lines in Wuz.Cmd that hide them.
  69.  
  70. NOTE: If you double-click on ZClr.Cmd from the WPS while the command-line
  71.       window is still open and in the extract directory, OS/2 will not be
  72.       able to remove the extract directory.
  73.  
  74.  
  75. Zipping Directories in Place
  76. ----------------------------
  77.  
  78. Sometimes I have whole directories I don't really need but I don't really
  79. want to erase either.  The most common example of this is games that I've
  80. finished but still might want to show to friends some time.  For situations
  81. like these, use Zip Directory.
  82.  
  83. You can use Zip Directory in one of two ways:
  84. 1) Open the drive tree from Drives and drag-and-drop the icon of the
  85.    subdirectory you want to zip up onto your "Zip Directory" icon.
  86. 2) Type ZIP-DIR <subdirectory-name> from a command line
  87.  
  88. This will not only move the whole directory into an icon, it will also
  89. change the folder icon into a zipped folder icon.  If you were to open the
  90. folder now, you would find a file called <subdirectory-name>.ZIF.
  91.  
  92. You can unzip this in one of five ways:
  93. 1) Drag the zipped folder icon from your drive tree to "WPS Unzip"
  94. 2) Drag the .ZIF file to "WPS Unzip"
  95. 3) Double click on the .ZIF file
  96. 4) Type WUZ <subdirectory-name> from a command line
  97. 5) Type WUZ <.ZIF filename> from a command line
  98.  
  99. After unzipping the files, WUZ will change the icon from a zipped folder to
  100. an unzipped folder.  If you rezip the directory, Zip Directory will simply
  101. update any files that have changed or been added and remove everything else so
  102. rezipping should be much faster.
  103.  
  104.  
  105. Other Goodies
  106. -------------
  107.  
  108. This archive also includes Open-Dir.Cmd which opens the specified directory
  109. as a folder on the desktop and Kill-Dir.Cmd which deletes the specified
  110. directory and all of its files.  These are pretty useful in their own right.
  111. Open-Dir.Cmd is also installed as OD.Cmd so typing "od subdirectory" will
  112. do it.
  113.  
  114. ZipStrip.Cmd may also be of interest.  It compares the files in the current
  115. directory to those in any ZIP file and offers to remove files from the ZIP
  116. that do not exist in the current directory or one of its subdirectories.
  117. This can take a little while.  I will probably rewrite this in C++ when
  118. I get a chance.
  119.  
  120.  
  121. Things You Might Want to Change
  122. -------------------------------
  123.  
  124. If you don't want a command-line, you can set KeepCommandLineWindow to 0
  125. at the top of Wuz.Cmd.  If you want Wuz to open the command-line and folder
  126. on the desktop before it is finished unpacking the archive, set WaitForUnzip
  127. to 0.  If you want WUZ to unzip the archive in the first window, set
  128. UnzipInCommandLineWindow to 0.
  129.  
  130. If you don't want to watch the archive being unpacked, you can open the
  131. settings page of "WPS Unzip", select Session and set Start Minimized then set
  132. UnzipInCommandLineWindow to 0 in WUZ.Cmd.  If you do this and set
  133. KeepCommandLineWindow to 0 in Wuz.Cmd, WUZ will only create the folder.
  134. While your at it, you could set Start Minimized on "Zip Directory" as well.
  135. For WPS purists, this is the way to go!
  136.  
  137. If you would rather the command-line always load another program, i.e. a text
  138. file viewer, etc. set FinalCommand to whatever you like in Post-Wuz.Cmd.  If
  139. you want to add any other commands to be executed every time, add them between
  140. the two comment lines at the top of Post-WUZ.Cmd.  This is a good place to
  141. load aliases for 4OS2 users since SHRALIAS is disabled for WUZ command line
  142. windows.
  143.  
  144. IMPORTANT:  Inst-Wuz will automatically preserve any of these changes that
  145.         you make if you reinstall.  Therefore, never modify these files
  146.         in the directory you are installing from.  Always modify them
  147.         in the executable directory.
  148.  
  149.         I will always keep these variables intact in new versions so you
  150.         should never have to worry about losing your changes when
  151.         reinstalling unless you modify something other than what I
  152.         have mentioned above.
  153.  
  154.  
  155. Coming Soon
  156. -----------
  157.  
  158. I will probably rewrite ZipStrip in C++ for speed.
  159.  
  160. Also, I will probably try to figure out a way to add Update and Refresh
  161. choices to the folder menu so that this feature can be accessed more easily
  162. form the WPS.
  163.  
  164. I should also be releasing my Extended Folder real-soon-now.  It will
  165. eventually provide an enhanced icon folder but currently it just adds
  166. Open Parent and Open Command-Line to the object menu of every folder.
  167. I will almost certainly need to use this to add Update and Refresh to the
  168. object menus of extract directories.
  169.  
  170.  
  171. For Rexx Programmers
  172. --------------------
  173.  
  174. First of all, I believe the install program "INST-WUZ.CMD" is pretty
  175. intelligent.  If you want to modify this and use it to install your own
  176. programs, you may do so.  I only ask that you leave in my seven line banner
  177. at the top.
  178.  
  179. There are two routines here that you might want to put in your REXX
  180. library.  One is Check4OS2 which returns 1 if the current shell is 4OS2
  181. instead of CMD.  The other is DIRECTORY which simply makes the standard
  182. DIRECTORY command always append a '\' and accept directory names with a
  183. trailing backslash.  The standard DIRECTORY command chokes on trailing
  184. backslashes unless you are specifying the root and it never returns
  185. a name with a trailing backslash unless the current directory is the root.
  186. My routine makes everything a bit more consistent and robust.
  187.  
  188. One other routine that you might want to check out is GetDriveSpec in Wuz.CMD.
  189. This will take a filename and return FullPath, FullName, Ext and NameOnly.
  190. This can even handle relative paths on different drives without changing
  191. your current directory on any drive.
  192.  
  193.  
  194.  
  195. Adding a New Archive Type
  196. -------------------------
  197.  
  198. If you want to add a different archiver, here is what you need to do.
  199. Edit Wuz.Cmd and go down to the Extractor.Ext = whatever section.
  200. The following explanation will make a lot more sense if you are looking
  201. at Wuz.Cmd as you read this.
  202.  
  203. A generic archiver definition consists of the following specifications:
  204.  
  205. Extractor.<ext> = '<dearchiver>'- where Ext is the actual extension you want
  206.                   to use and <dearchiver> includes any
  207.                   necessary switches.  You should always
  208.                   setup your dearchiver to extract subdirec-
  209.                   tories and automatically overwrite if
  210.                   possible.
  211. CopyTo.<ext>    = Yes/No    - Some dearchivers must extract to the same
  212.                   directory that the archive is in.  These
  213.                   will require that the archive be copied to
  214.                   the extract directory first.  Usually,
  215.                   however, this will be no.
  216. Update.<ext>    = '<archiver>'    - This should be your archive command with
  217.                   switches to update files and work
  218.                   recursively.
  219. UpdateP.<ext>    = '<exclude>'    - This is a switch to stick on to the tail
  220.                   end of the archive command to exclude
  221.                   ZCLR.CMD, ZUPDATE.CMD and ZFRESH.CMD.
  222. Fresh.<ext>    = '<archiver>'    - This should be your archive command with
  223.                   switches to update only those files that
  224.                   have changed and already exist in the
  225.                   archive.  Don't forget any necessary
  226.                   switches to work recursively through any
  227.                   subdirectories.
  228.  
  229.  
  230. Legalities
  231. ----------
  232.  
  233. Okay, now for the legal stuff.  I use these routines constantly and have had
  234. no problems.  If you do, let me know.  However, I can not be held liable if
  235. anything nasty happens.  This software is strictly of the "USE AT YOUR OWN
  236. RISK" variety.
  237.  
  238. I am asking $20 for WPS Unzip.  I think this is probably fair.  If you make
  239. a lot of money and WUZ saves you tons of time you could send me more.
  240. On the other hand, if you are a starving student, just send me email telling
  241. me what you think and we'll call it even.  I am currently living in Japan
  242. so I know how hard it can be to send checks from outside the U.S.  If you
  243. are an international user, send me either cash or email.  If your local
  244. currency is pretty major, send me that and I'll try to exchange it.
  245. Any checks should be made out to my mother:
  246.  
  247.   Patricia Maxwell
  248.   1587 E. Modesto Ave.
  249.   Camarillo, CA 93010
  250.   U.S.A.
  251.  
  252. It costs me about $20 to cash a check in Japan, so this makes more sense
  253. for me.
  254.  
  255. Comments are welcome.  I hope these REXX routines are as useful for you
  256. as they have been for me.  I haven't found any easier way to explore
  257. archives.  Send comments to me at scott.maxwell@channel1.com.
  258.  
  259. --------------------- Usenet: scott.maxwell@channel1.com ---------------------
  260.